home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / ead / ead03.dms / ead03.adf / Progs / DirUtil / Dirutil.doc < prev    next >
Text File  |  1988-03-01  |  8KB  |  153 lines
  1. /***********
  2.         D I R U T I L   I I   - a file/disk utility program
  3.                 Orignal Version by Chris Nicotra
  4.                 Revisions/Enhancements/Fixes by Dave Jobusch
  5.                                         ...umn-cs!isucs1!jobusch
  6.  
  7. 10/6/86 Version 1.4 by Rich Medved CIS 72366,540
  8.  
  9.    A feature that I really like is being able to get a screen 
  10. display of ASCII files from programs like "Sweep".  The only 
  11. version of DirUtil that has ever had this lacked the numerous 
  12. gadget buttons of this version.  Unfortunately, on that version, 
  13. the individual that added the TYPE feature, decided to keep the 
  14. code.  It's a pity, he had a good implimentation.  When I found this 
  15. version on a local board,  there were only two things that I didn't like. 
  16. The lack of a TYPE was one.  The other is that I have three floppies on my 
  17. Amiga, but the utility only had gadgets for df0: and df1:.  Well, now it 
  18. supports df2:.  When I compiled the code, I got over 50 compilier warnings, 
  19. I cleaned up over half of them and, hopefully, didn't add any new ones. 
  20. Don't worry about the  warnings, the code compiles and links fine -- it's 
  21. just  that I got tired of looking for errors in midst of the field of 
  22. warnings. It compiled fine with Lattice 3.03 and Manx 3.2
  23.  
  24.         This program is in the public domain. That means you can't
  25.         sell the damn thing to anyone, and further more, I doubt
  26.         you'd get much for it. As a matter of fact, I beat this
  27.         thing to death for 2 weeks, and it still isn't perfect,
  28.         but it works. I got the original program from a BBS 
  29.         in Omaha, and do not know who Chris Nicotra is.
  30.  
  31.         Enhancements, suggestions, thanks, money should be sent
  32.         to isucs1!jobusch (Dave Jobusch). Flames, nasty comments
  33.         to /dev/null.
  34.  
  35.         Instructions:
  36.         Click on file or directory names in the file window to 
  37.         select a file to take action on. Click on one of the
  38.         many gadgets to take the selected action on the selected
  39.         files/directory (yes, only one directory at a time).
  40.         The three string gadgets at the bottom are:
  41.                 C: The current directory. Mess with this. If you
  42.                    enter an existing path, you just selected the
  43.                    new current directory.
  44.                 D: The destination gadget. This one is used to enter
  45.                    destination directories, and is also where you
  46.                    enter requests for directories to create.
  47.             3rd  : Status window. Error descriptions and DOS error
  48.                    numbers appear here. Entries of text into this
  49.                    gadget will result in the destruction of the world.
  50.  
  51.  
  52.         df0:,df1:,df2,ram:,hd0: --->
  53.                 Set current directory to the root of the selected device.
  54.  
  55.         ALL --->
  56.                 Select ALL files in the current directory, including
  57.                 the ones "scrolled off" the window.
  58.         CLEAR --->
  59.                 De-select all selected files
  60.         COPY --->
  61.                 Copy selected files to the directory specified in the
  62.                 second string gadget. Mind you, you CANNOT enter a
  63.                 filename here. It must be an existing directory 
  64.                 path and CAN go across devices. You should be able
  65.                 to enter paths relative to the current directory.
  66.                 (I think I fixed that...) 
  67.         DELETE --->
  68.                 Delete selected files. Will not delete directories.
  69.         RENAME --->
  70.                 Renames first selected file or directory to the name
  71.                 or path (on the same device) in the second string
  72.                 gadget.
  73.         GETDIR --->
  74.                 If you want to go to a new directory, select
  75.                 a directory in the file window, and click on this
  76.                 gadget. DO NOT USE this to get a directory that is
  77.                 listed in the first string gadget! If you must type
  78.                 it in, you hit return while in the string gadget -
  79.                 then that will be your new current directory.
  80.         MAKEDIR --->
  81.                 This will create the directory that you have typed in
  82.                 the second string gadget. You MAY use relative paths.
  83.         DELETEDIR --->
  84.                 This will delete the non-empty diretory that you have
  85.                 selected in the file window. You will get and error
  86.                 if the directory is not empty.
  87.         PARENT --->
  88.                 Go to the parent directory
  89.         ROOT --->
  90.                 Go to the root of the current device
  91.         LIST --->
  92.                 Use this to generate lists of files on your disks. It
  93.                 will write out to stdout the files that you have selected.
  94.                 If anyone has a neat way to retrieve the volume name of
  95.                 a device, please fix this so that the volume name will
  96.                 be added to the beginning of each file listed.
  97.                 Remember, you need to redirect output to a file if you
  98.                 want to save the listings.
  99.         TYPE --->
  100.                 Use this to view standard ASCII (readme, docs, etc) on
  101.                 stdout; usually your CRT.  Select the files you want to
  102.                 view, then select the TYPE gadget.  A new window, with 
  103.                 the window name being the file that you are currently
  104.                 viewing, will open.  Use the space bar to advance by one
  105.                 screen, a <CR> will advance one line.  Entering ESC will
  106.                 advance you to the end of that file.  The space bar will
  107.                 then exit from that file.  If you have selected to view
  108.                 more than one file, the next will automatically be
  109.                 displayed.  After all selected files have been viewed,
  110.                 the window will close, returning you to DirUtil's main
  111.                 screen.
  112.         SHOWILBM --->
  113.                 If you select this to be included, the program will
  114.                 copy a SHOWIBLM command into the ram disk, and will lock
  115.                 it (to save it frlom accidental deletion), and then
  116.                 will perform consecutive Execute's to show the selected
  117.                 files. The show command that has been floating around
  118.                 here needs you to click the upper left hand corner
  119.                 after showing each file - so there is no loop to wait
  120.                 for a picture to show. NOTE: Beware of the 1.1 Execute
  121.                 bug that eats 30+ bytes every time.
  122.  
  123.         NEW NOTES: 6-Aug
  124.                 Because of a problem with locking and unlocking the
  125.                 current directory on a disk that had been removed,
  126.                 I had to make a change to what the program defaulted
  127.                 to (for a current directory).
  128.                 Changes made:
  129.                         - Initial current directory is ALWAYS set to RAM: 
  130.                         - if you really confuse it, it will go to RAM:
  131.                           rather than SYS:
  132.                         - PWD routine no longer needed, so I combined the
  133.                           dirutil and qsort source into one file. (Follows)
  134.                         - so now, to compile, simply
  135.  
  136.                         cc +f +l -s dirutil.c
  137.                         ln dirutil.o -lc32
  138.  
  139.  
  140.                 I forgots :
  141.                         I neglected to mention a rather important feature.
  142.                         If you did something stupid like select all files
  143.                         and then hit delete, and suddenly realize that
  144.                         you REALLY didnt want to do that, there is a
  145.                         STOP IDIOT feature. When you are doing operations
  146.                         on a group of files, CLICKING ANYWHERE IN THE
  147.                         WINDOW WILL ABORT THE OPERATION.
  148.  
  149.         Sorry about any problems this has caused. Please don't sue me
  150.         if this program wipes out a disk of yours. I have been using
  151.         the program for about 2 weeks now, and have not munged anything.
  152.         Guru reports would be appreciated.
  153.